home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / pxfopen.z / pxfopen
Encoding:
Text File  |  1998-10-30  |  6.2 KB  |  142 lines
  1. PXFOPEN(3F)                                            Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      PPXXFFOOPPEENN - Provides a Fortran interface to the ooppeenn(2) system call
  6.  
  7. SSYYNNOOPPSSIISS
  8.      IINNTTEEGGEERR _i_l_e_n,, _i_o_p_e_n_f_l_a_g,, _i_m_o_d_e,, _i_f_i_l_d_e_s,, _i_e_r_r_o_r
  9.      CCHHAARRAACCTTEERR*_n _p_a_t_h
  10.      CCAALLLL PPXXFFOOPPEENN((_p_a_t_h,, _i_l_e_n,, _i_o_p_e_n_f_l_a_g,, _i_m_o_d_e,, _i_f_i_l_d_e_s,, _i_e_r_r_o_r))
  11.  
  12. IIMMPPLLEEMMEENNTTAATTIIOONN
  13.      UNICOS, UNICOS/mk, and IRIX systems
  14.  
  15. SSTTAANNDDAARRDDSS
  16.      IEEE standard interface for FORTRAN 77
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
  20.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  21.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  22.      7.2 F77 compiler.
  23.  
  24.      The routine PPXXFFOOPPEENN provides a subset of the functionality of the
  25.      ooppeenn(2) system call.
  26.  
  27.      The _p_a_t_h argument identifies the file to be opened.  If PPXXFFOOPPEENN
  28.      successfully opens the file, the file descriptor is returned in the
  29.      argument _i_f_i_l_d_e_s, and _i_e_r_r_o_r is set to zero.  If the file cannot be
  30.      opened, _i_e_r_r_o_r is set to the error value.
  31.  
  32.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  33.      UNICOS, UNICOS/mk, or IRIX, all arguments must be of default kind
  34.      unless documented otherwise.  On UNICOS and UNICOS/mk, default kind is
  35.      KKIINNDD==88 for integer, real, complex, and logical arguments; on IRIX, the
  36.      default kind is KKIINNDD==44.
  37.  
  38.      The following is a list of arguments for this routine:
  39.  
  40.      _p_a_t_h      An input character variable or array element containing the
  41.                name of the file to be opened.
  42.  
  43.      _i_l_e_n      An input integer variable containing the length of _p_a_t_h in
  44.                characters.  If _i_l_e_n is zero, the trailing blanks are
  45.                removed.
  46.  
  47.      _i_o_p_e_n_f_l_a_g An input integer variable containing the status flags.  See
  48.                the ooppeenn(2) man page for more detail.  The value for this
  49.                variable may be obtained through the use of PPXXFFCCOONNSSTT(3F) or
  50.                IIPPXXFFCCOONNSSTT.  The following values are currently supported for
  51.                _i_o_p_e_n_f_l_a_g:
  52.  
  53.                * OO__RRDDOONNLLYY
  54.  
  55.                * OO__WWRROONNLLYY
  56.  
  57.                * OO__RRDDWWRR
  58.  
  59.                * OO__RRAAWW*
  60.  
  61.                * OO__LLDDRRAAWW*
  62.  
  63.                * OO__NNDDEELLAAYY
  64.  
  65.                * OO__NNOONNBBLLOOCCKK
  66.  
  67.                * OO__NNOOCCTTTTYY
  68.  
  69.                * OO__BBIIGG*
  70.  
  71.                * OO__AAPPPPEENNDD
  72.  
  73.                * OO__CCRREEAATT
  74.  
  75.                * OO__TTRRUUNNCC
  76.  
  77.                * OO__EEXXCCLL
  78.  
  79.                * OO__PPLLAACCEE*
  80.  
  81.                * OO__RREESSTTAARRTT*
  82.  
  83.                * OO__SSSSDD*
  84.  
  85.                * OO__SSYYNNCC
  86.  
  87.                * OO__WWEELLLLFFOORRMMEEDD*
  88.  
  89.                * = UNICOS and UNICOS/mk systems only.
  90.  
  91.                The integer values may be combined through the use of a
  92.                bitwise inclusive OORR function.
  93.  
  94.      _i_m_o_d_e     An input integer variable, denoting the file access
  95.                permission.  The value for this variable may be retrieved
  96.                through the use of PPXXFFCCOONNSSTT or IIPPXXFFCCOONNSSTT.  The following
  97.                values are currently supported for _i_m_o_d_e:
  98.  
  99.                UUSSEERR      RREEAADD permissions bit:  SS__IIRRUUSSRR
  100.                          WWRRIITTEE permissions bit:  SS__IIWWUUSSRR
  101.                          SSEEAARRCCHH//EEXXEECCUUTTEE permissions bit:  SS__IIXXUUSSRR
  102.                          Inclusive OORR of RREEAADD//WWRRIITTEE//EEXXEECCUUTTEE:  SS__IIRRWWXXUU
  103.  
  104.                GGRROOUUPP     RREEAADD permissions bit:  SS__IIRRGGRRPP
  105.                          WWRRIITTEE permissions bit:  SS__IIWWGGRRPP
  106.                          SSEEAARRCCHH//EEXXEECCUUTTEE permissions bit:  SS__IIXXGGRRPP
  107.                          Inclusive OORR of RREEAADD//WWRRIITTEE//EEXXEECCUUTTEE:  SS__IIRRWWXXGG
  108.  
  109.                OOTTHHEERR     RREEAADD permissions bit:  SS__IIRROOTTHH
  110.                          WWRRIITTEE permissions bit:  SS__IIWWOOTTHH
  111.                          SSEEAARRCCHH//EEXXEECCUUTTEE permissions bit:  SS__IIXXOOTTHH
  112.                          Inclusive OORR of RREEAADD//WWRRIITTEE//EEXXEECCUUTTEE:  SS__IIRRWWXXOO
  113.  
  114.                SSEETTIIDD     Set user IIDD on execution:  SS__IISSUUIIDD
  115.                          Set group IIDD on execution:  SS__IISSGGIIDD
  116.  
  117.                          The integer values may be combined through the use
  118.                          of a bitwise inclusive OORR function.
  119.  
  120.      _i_f_i_l_d_e_s   An output integer variable.  If the ooppeenn system call was
  121.                successful, _i_f_i_l_d_e_s will be set to the file descriptor.
  122.  
  123.      _i_e_r_r_o_r    An output integer variable containing the status:
  124.  
  125.                0         If PPXXFFOOPPEENN was successful (the ooppeenn(2) succeeded)
  126.  
  127.                _e_r_r_n_o     If the ooppeenn(2) system call failed
  128.  
  129.                EEIINNVVAALL    If _i_l_e_n is less than 0 or _i_l_e_n is greater than
  130.                          LLEENN((_p_a_t_h))
  131.  
  132. NNOOTTEESS
  133.      PPXXFFOOPPEENN does not provide a way to specify the _c_b_i_t_s or _c_b_l_k_s
  134.      parameters to ooppeenn(2).
  135.  
  136. SSEEEE AALLSSOO
  137.      ooppeenn(2)
  138.  
  139.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
  140.      2165, for the printed version of this man page.
  141.  
  142.